<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>对比两个「PHP 规范化」的版本数字字符串</title>
 </head>
 <body class="docs"><div id="layout">
  <div id="layout-content"><div id="function.version-compare" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">version_compare</h1>
  <p class="verinfo">(PHP 4 &gt;= 4.1.0, PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">version_compare</span> &mdash; <span class="dc-title">对比两个「PHP 规范化」的版本数字字符串</span></p>

 </div>
 
 <div class="refsect1 description" id="refsect1-function.version-compare-description">
  <h3 class="title">说明</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>version_compare</strong></span>
    ( <span class="methodparam"><span class="type">string</span> <code class="parameter">$version1</code></span>
   , <span class="methodparam"><span class="type">string</span> <code class="parameter">$version2</code></span>
   [, <span class="methodparam"><span class="type">string</span> <code class="parameter">$operator</code></span>
  ] ) : <span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span></div>

  <p class="para rdfs-comment">
   <span class="function"><strong>version_compare()</strong></span> 用于对比两个「PHP 规范化」的版本数字字符串。
  </p>
  <p class="para">
   此函数首先在版本字符串里用一个点 <em>.</em> 替换 <em>_</em>、<em>-</em> 和 <em>+</em>，也会在任意非数字前后插入一个点 <em>.</em>，这样，类似 &#039;4.3.2RC1&#039; 将会变成 &#039;4.3.2.RC.1&#039;。
   接下来它会分割结果，
   然后它会从左往右对比各个部分。
   如果某部分包含了特定的版本字符串，将会用以下顺序处理：
   <em>列表中未找到的任意字符串</em> &lt; 
   <em>dev</em> &lt; <em>alpha</em> =
   <em>a</em> &lt; <em>beta</em> =
   <em>b</em> &lt; <em>RC</em> =  
   <em>rc</em> &lt; <em>#</em> &lt;
   <em>pl</em> = <em>p</em>。
   
   这种方式不仅能够对比类似 &#039;4.1&#039; 和 &#039;4.1.2&#039; 那种不同的版本级别，同时也可以指定对比任何包含 PHP 开发状态的版本。
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.version-compare-parameters">
  <h3 class="title">参数</h3>
  <p class="para">
   <dl>

    
     <dt>
<code class="parameter">version1</code></dt>

     <dd>

      <p class="para">
       第一个版本数。
      </p>
     </dd>

    
    
     <dt>
<code class="parameter">version2</code></dt>

     <dd>

      <p class="para">
       第二个版本数。
      </p>
     </dd>

    
    
     <dt>
<code class="parameter">operator</code></dt>

     <dd>

      <p class="para">
       如果你指定了可选的第三个参数 <code class="parameter">operator</code>，你可以测试两者的特定关系。
       可以的操作符分别是：<em>&lt;</em>、
       <em>lt</em>、<em>&lt;=</em>、
       <em>le</em>、<em>&gt;</em>、
       <em>gt</em>、<em>&gt;=</em>、
       <em>ge</em>、<em>==</em>、
       <em>=</em>、<em>eq</em>、
       <em>!=</em>、<em>&lt;&gt;</em> 和
       <em>ne</em>。
      </p>
      <p class="para">
       此参数区分大小写，它的值应该是小写的。
      </p>
     </dd>

    
   </dl>

  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.version-compare-returnvalues">
  <h3 class="title">返回值</h3>
  <p class="para">
   
   默认情况下，在第一个版本低于第二个时，<span class="function"><strong>version_compare()</strong></span> 返回 <em>-1</em>；如果两者相等，返回 <em>0</em>；第二个版本更低时则返回 <em>1</em>。
  </p>
  <p class="para">
   当使用了可选参数 <code class="parameter">operator</code> 时，如果关系是操作符所指定的那个，函数将返回 <strong><code>TRUE</code></strong>，否则返回 <strong><code>FALSE</code></strong>。
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.version-compare-examples">
  <h3 class="title">范例</h3>
  <p class="para">
   下例使用了 <strong><code>PHP_VERSION</code></strong> 常量，因为它执行的代码包含了 PHP 版本的值。
  </p>
  <p class="para">
   <div class="example" id="example-536">
    <p><strong>Example #1 <span class="function"><strong>version_compare()</strong></span> examples</strong></p>
    <div class="example-contents">
<div class="phpcode"><pre><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">if&nbsp;(</span><span style="color: #0000BB">version_compare</span><span style="color: #007700">(</span><span style="color: #0000BB">PHP_VERSION</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'7.0.0'</span><span style="color: #007700">)&nbsp;&gt;=&nbsp;</span><span style="color: #0000BB">0</span><span style="color: #007700">)&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;</span><span style="color: #DD0000">'I&nbsp;am&nbsp;at&nbsp;least&nbsp;PHP&nbsp;version&nbsp;7.0.0,&nbsp;my&nbsp;version:&nbsp;'&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #0000BB">PHP_VERSION&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />}<br /><br />if&nbsp;(</span><span style="color: #0000BB">version_compare</span><span style="color: #007700">(</span><span style="color: #0000BB">PHP_VERSION</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'5.3.0'</span><span style="color: #007700">)&nbsp;&gt;=&nbsp;</span><span style="color: #0000BB">0</span><span style="color: #007700">)&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;</span><span style="color: #DD0000">'I&nbsp;am&nbsp;at&nbsp;least&nbsp;PHP&nbsp;version&nbsp;5.3.0,&nbsp;my&nbsp;version:&nbsp;'&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #0000BB">PHP_VERSION&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />}<br /><br />if&nbsp;(</span><span style="color: #0000BB">version_compare</span><span style="color: #007700">(</span><span style="color: #0000BB">PHP_VERSION</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'5.0.0'</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'&gt;='</span><span style="color: #007700">))&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;</span><span style="color: #DD0000">'I&nbsp;am&nbsp;at&nbsp;least&nbsp;PHP&nbsp;version&nbsp;5.0.0,&nbsp;my&nbsp;version:&nbsp;'&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #0000BB">PHP_VERSION&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />}<br /><br />if&nbsp;(</span><span style="color: #0000BB">version_compare</span><span style="color: #007700">(</span><span style="color: #0000BB">PHP_VERSION</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'5.0.0'</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'&lt;'</span><span style="color: #007700">))&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;</span><span style="color: #DD0000">'I&nbsp;am&nbsp;still&nbsp;PHP&nbsp;4,&nbsp;my&nbsp;version:&nbsp;'&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #0000BB">PHP_VERSION&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</pre></div>
    </div>

   </div>
  </p>
 </div>


 <div class="refsect1 notes" id="refsect1-function.version-compare-notes">
  <h3 class="title">注释</h3>
  <blockquote class="note"><p><strong class="note">Note</strong>: 
   <p class="para">
    <strong><code>PHP_VERSION</code></strong> 常量包含了当前 PHP 的版本。
   </p>
  </p></blockquote>
  <blockquote class="note"><p><strong class="note">Note</strong>: 
   <p class="para">
    注意，类似 5.3.0-dev 的预发行版本，被认为是低于它们的最终发行版本（就像 5.3.0）。
   </p>
  </p></blockquote>
  <blockquote class="note"><p><strong class="note">Note</strong>: 
   <p class="para">
    指定类似 <em>alpha</em>、<em>beta</em> 的版本字符串是大小写敏感的。
    版本字符串的来源若不遵循 PHP 标准，可能需要在调用 <span class="function"><strong>version_compare()</strong></span> 之前先用 <span class="function"><a href="strtolower.html" class="function">strtolower()</a></span> 转成小写。
   </p>
  </p></blockquote>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.version-compare-seealso">
  <h3 class="title">参见</h3>
  <p class="para">
   <ul class="simplelist">
    <li class="member"><span class="function"><a href="phpversion.html" class="function" rel="rdfs-seeAlso">phpversion()</a> - 获取当前的PHP版本</span></li>
    <li class="member"><span class="function"><a href="php_uname.html" class="function" rel="rdfs-seeAlso">php_uname()</a> - 返回运行 PHP 的系统的有关信息</span></li>
    <li class="member"><span class="function"><a href="function_exists.html" class="function" rel="rdfs-seeAlso">function_exists()</a> - 如果给定的函数已经被定义就返回 TRUE</span></li>
   </ul>
  </p>
 </div>


</div></div></div></body></html>